package com.cencat.user.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.cencat.common.response.PageResponse;
import com.cencat.user.dto.RolePermissionDTO;
import com.cencat.user.dto.RolePermissionQueryDTO;
import com.cencat.user.vo.RolePermissionVO;
import com.cencat.common.exception.BusinessException;

import java.util.List;

/**
 * 角色权限关联服务接口
 * @author cencat
 * @since 2024-01-01
 */
public interface RolePermissionService {

    /**
     * 分配角色权限
     * @param dto 角色权限DTO
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean assignRolePermissions(RolePermissionDTO dto) throws BusinessException;

    /**
     * 移除角色权限
     * @param dto 角色权限DTO
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean removeRolePermissions(RolePermissionDTO dto) throws BusinessException;

    /**
     * 更新角色权限
     * @param dto 角色权限DTO
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean updateRolePermissions(RolePermissionDTO dto) throws BusinessException;

    /**
     * 根据角色ID查询权限列表
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 权限列表
     * @throws BusinessException 业务异常
     */
    List<RolePermissionVO.PermissionInfo> getPermissionsByRoleId(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 根据权限ID查询角色列表
     * @param permissionId 权限ID
     * @param tenantId 租户ID
     * @return 角色列表
     * @throws BusinessException 业务异常
     */
    List<RolePermissionVO> getRolesByPermissionId(Long permissionId, Long tenantId) throws BusinessException;

    /**
     * 分页查询角色权限关联
     * @param queryDTO 查询条件
     * @return 分页结果
     * @throws BusinessException 业务异常
     */
    PageResponse<RolePermissionVO> getRolePermissionPage(RolePermissionQueryDTO queryDTO) throws BusinessException;

    /**
     * 查询角色权限关联列表
     * @param queryDTO 查询条件
     * @return 角色权限关联列表
     * @throws BusinessException 业务异常
     */
    List<RolePermissionVO> getRolePermissionList(RolePermissionQueryDTO queryDTO) throws BusinessException;

    /**
     * 检查角色是否拥有权限
     * @param roleId 角色ID
     * @param permissionId 权限ID
     * @param tenantId 租户ID
     * @return 是否拥有权限
     * @throws BusinessException 业务异常
     */
    Boolean checkRoleHasPermission(Long roleId, Long permissionId, Long tenantId) throws BusinessException;

    /**
     * 检查角色是否拥有权限编码
     * @param roleId 角色ID
     * @param permissionCode 权限编码
     * @param tenantId 租户ID
     * @return 是否拥有权限
     * @throws BusinessException 业务异常
     */
    Boolean checkRoleHasPermissionCode(Long roleId, String permissionCode, Long tenantId) throws BusinessException;

    /**
     * 根据权限ID列表查询角色ID列表
     * @param permissionIds 权限ID列表
     * @param tenantId 租户ID
     * @return 角色ID列表
     * @throws BusinessException 业务异常
     */
    List<Long> getRoleIdsByPermissionIds(List<Long> permissionIds, Long tenantId) throws BusinessException;

    /**
     * 根据角色ID列表查询权限ID列表
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @return 权限ID列表
     * @throws BusinessException 业务异常
     */
    List<Long> getPermissionIdsByRoleIds(List<Long> roleIds, Long tenantId) throws BusinessException;

    /**
     * 统计角色权限关联数量
     * @param tenantId 租户ID
     * @return 关联数量
     * @throws BusinessException 业务异常
     */
    Long countRolePermissions(Long tenantId) throws BusinessException;

    /**
     * 统计角色的权限数量
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 权限数量
     * @throws BusinessException 业务异常
     */
    Long countPermissionsByRoleId(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 统计权限的角色数量
     * @param permissionId 权限ID
     * @param tenantId 租户ID
     * @return 角色数量
     * @throws BusinessException 业务异常
     */
    Long countRolesByPermissionId(Long permissionId, Long tenantId) throws BusinessException;

    /**
     * 根据角色ID删除权限关联
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 删除数量
     * @throws BusinessException 业务异常
     */
    Integer deleteByRoleId(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 根据权限ID删除角色关联
     * @param permissionId 权限ID
     * @param tenantId 租户ID
     * @return 删除数量
     * @throws BusinessException 业务异常
     */
    Integer deleteByPermissionId(Long permissionId, Long tenantId) throws BusinessException;

    /**
     * 查询角色权限详情
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 角色权限详情
     * @throws BusinessException 业务异常
     */
    RolePermissionVO getRolePermissionDetail(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 批量分配角色权限
     * @param roleIds 角色ID列表
     * @param permissionIds 权限ID列表
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean batchAssignRolePermissions(List<Long> roleIds, List<Long> permissionIds, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 批量移除角色权限
     * @param roleIds 角色ID列表
     * @param permissionIds 权限ID列表
     * @param tenantId 租户ID
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean batchRemoveRolePermissions(List<Long> roleIds, List<Long> permissionIds, Long tenantId) throws BusinessException;

    /**
     * 复制角色权限
     * @param sourceRoleId 源角色ID
     * @param targetRoleId 目标角色ID
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean copyRolePermissions(Long sourceRoleId, Long targetRoleId, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 清空角色权限
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean clearRolePermissions(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 同步角色权限
     * @param roleId 角色ID
     * @param permissionIds 权限ID列表
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 操作结果
     * @throws BusinessException 业务异常
     */
    Boolean syncRolePermissions(Long roleId, List<Long> permissionIds, Long tenantId, Long operatorId) throws BusinessException;
}